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Introduction 


Think you lor buying this copy of ZEN. If you have any questions 
about ZEN th«n please feel fr«o to writs to Avalon Softwar■, ovary 
enquiry receives a raply. All high loval 1anguagts have perforaance 
1ieitatlonx, whan you need tha aaxisum In speed and flexibility tha 
answer Hat In Atstably Language prograeming. ZEN provides you with 
tha tools to generate or analyte ZSI Attaebly Language programs. 

Starting up 

\ 

Unlike BASIC, which la peraanantly available in RON, you need to 
load ZEN froa caiaette. It it stored on the cassette as a binary 
file designed to run at address AIIIM. BASIC usually atsuaat that it 
has the whole of mmsory to Itself. To ensure that BASIC end ZEN 
coexist peacefully it is necessary to change the top of eaaory 
before loading froa cassette. The loading procedure is therefore as 
follows) 

111 Type clear 2>V,AH7FFF(RETURN) 

12) Type bload’ZEK*,R(R£TURN1 

BASIC will then load ZEN into eeaory and transfer control 
automatically when loading It finished. 

Coaeand level 

Whenever the prompt Z£N> is displayed you are at coamand level, 


you may execute any of 

the following 

coaeandst 

A 


Q. 

Out 

B 


f . 

Print 

C 


9 .. 

Query 

D 


R. 

Reed 

E 

Enter 

S. 

Sort 

F 

. Fill 

T . 

Target 

8 


U. 

Up 

H 


V. 

Verify 

I 


W. 

Write 

K 


I. 

laeine 

l 


Z. 

Zap 

N 


a. 


N 


.. 

unscramble 

To 

select a given command type in 

the first 1etter 


followed by a parameter If relevant, and then press the 1RETURN) 
key. The IBS) key can be used to backspace while (DEL) will turn the 
cassette motor on or off. The usage of coamand loop parameter a is 
explained in greater detail in the next section, which examines each 
command In depth. If ZEN doesn't understand anything you’ve typed in 
it will display the error etssage HUH? The default command, just 
pressing (RETURN) on it's own, will clear the screen and set It to 
wide screen text mode. This is the preferred screen mode within ZEN. 
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New Thii coaaand lets you nodify tkl current line of (ha last Ilia. 
The lint it displayed »ith tha carter at (he righteost petit!an* 
Change tha line and prate (RETURN) te restore tha nee line to tha 
teat Ilia. 

Out Thit contend till output a data value to tha I/O port tpaeifiad 
by tha coaaand paranater. You till ha proaptad for tha data 
paraaetar. 

Print Thii coaaand displays « nueber el lines Iron ths test Ills on 
tha acratn. The nether of lints it specified by the coaaand 
peraaeter, for atatplt Rf(RETURN) would display nine tints* The 
dafault coaaand paraaetar la one. The display coeeencei with the 
current line and the last line displayed becoatt the new current 
line* 

Query This coaaand* displays siity-four bytes oi ssaory in hes and 
ASCII. The coaaand parameter specilits tha start address, lor 
esaapla BAIIIHiRETURN) would display the start ol ZEN, II you supply 
no address paraaetar then the display begins free where it last 
finished. 

Read Thit coeaand reads a file froa cassette into aetory, the 
coaaand paraaater specilits tha type ol file. 

KtRCTURNI will raid a test fi It and appand it to tha and of any 
test already esisting in atadry. You will be proapted for a 
filcnawe. A fllenaae nay be Iroa tero to sis characters long, II the 
lilenaaa is aero characters long - then ZEN will load the first test 
file it finds on the cassette. If the test lilt reaches UN's top ol 
ateory Halt then reading terminates and the error ••■sage HENDRY is 
displayed. 

Rl(RETURN) will read a binary lilt into aaeory. You will be 
proaptad for an addrass , to IQA&> the ftie at. If you supply an 
address paraaater thaa tha file will la loaded coaaanctng at that 
address. If you default, by just pressing,(RETURN!, then tha file 
will be loaded at the address defined in the file header. The 
execution address of the file is placed in the User Rrogr an Counter 
for later execution if required. 

Note that the tCTRt-STOP) key cm be used to abort any I/O 
operation in progress but has no other action within ZEN. 
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Soto This coeaind loads tht ZBI reglster s with th* User tii)t and 
transfers control to the address spec1ftad in th* coaaand paraeeter. 
Fori exaaple 6KRETURN) would perfore t complete lyctaa cold start. 
If ho coaaand paraaet or it supplied than control It traniftrrad to 
th# address in th# U*#r Prograe Counter. You will than ba proaptad 
for a breakpoint addrett. If you ratpond with a valid addrett 
paraeeter then a breakpoint it set at that addrett. If you default, 
by Jutt pressing (RETURN), than no breakpoint It eat. A breakpoint 
it a way of itopping a running prograa. A Z88 CALL inttruction it 
placed in the prograa to return control to the ZEN trap handler. The 
trap handler will eava all the ZSI regiitere in the Uttr Iwage area 
and rettore th* code under the breakpoint before returning to the 
ZEN contend loop. You can thus exaaine the itate of the Z8S at -the 
tiae of the breakpoint. You can continue execution by using" thi 
6(RETURN) coaaand as the Prograa Counter is saved as part of the 
trap process. Application progress aay taminata with a slapla juep 
back to the ZEN ENTRY or REENTRY points, the only difference between 
these two points is that REENTRY saves the Z89 registers while ENTRY 
doesn't. Note that ZEN tries to perfora as little Initialisation at 
possible upon entry to keep everything 'wars’. 

Howblg This coaaand displays, in hexadecisal, the start and end 
addresses of the text file and the top of neaory. ZEN will allow the 
text file to grow up to this top Unit but no further. You can 
change this Halt if required (see ZEN listing, the UNIT constant). 

In This contend will display, in hexadecieal and binary, the data 
read fro* th* I/O port specified by the coaaand paraeeter, For 
exaaple I?IH(RETURN) would read the printer status port. 

kill This coaaand erases the text file, as with the NEW statement in 
BASIC. It is possible to recover an accidentally KILLED file as ZEN 
just wakes t"he EOF pointer equal to the SOF pointer, the actual text 
will still be In aeaory. Find the address of the last text 
character, this will be an ASCII Carriage Return code (8DH). 
Increase this by one and use the MODIFY coaaand to restore the EOF 
pointer (tee ZEN listing, EQFP). 

Locate This coaaand is used to search the text file for a particular 
string of characters. The character string fares the coaaand 
paraeeter. For exaaple LBIT 7,A(RETURM) would find the first 
occurrence of the string BIT 7,A in the text file. The text file is 
searched froe the line after the current line. If the string is 
found then that line is aide the current line. If the search fails 
you are at *nd-of-f11*. There are ho restrictions on the contents of 
the paraaeter string. 

Red! fy This coeeind allows you to 'sxaaine and altar aeaory contents. 
The start address is specified by the coaaand paraaeter. For exaaple 
NDIBIH(RETURN) would cause the coaaand to start at DB8IH. If you 
supply no address paraaeter then the coaaand contlnuts fro* where it 
last finished. The byte at the address is displayed in hex and ZEN 
proapts for a data paraaeter froe you. If you supply * paraeeter 
then it is stored at that address, if you default ZEN just steps 
onto the next address. To return to coaaand level type « full stop. 
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Asitabl* The function of the imiblir Is to ruf a series of 
attaably 1 snguage stateaants and to product th* corresponding ZBI 
aicMni code end 11 itln)> Tht ZEN editing coeaands art uitd to 
craatt a text fit* in ataory• usually cal ltd tht source flit, which 
Is tht input to tht astaabltr. Output of the aachint cods flit, 
usually calltd tht objact fiIt, is controlled by the LOAD operator 
(sat under PSEUDO-OPS). The listing output is specified by you in 
response to the OPTION) proapt froa the asseobler. You tey specify 
V(RETURN), E(RETURN), P(RETURN) or (RETURN) for video, external, 
printer or null list output. The null output option Is auch tha 
fastest aode (the asstabler is peripheral-bound) and should be used 
until all syntax errors are corrected. The text file Is read 
beginning at the atart-of-fI1t and stopping when the END operator is 
found. 

Bye This coeaand gives a ware return to BASIC, any BASIC prograas in 
ataory are unaffected. If you then want to return to ZEN without re¬ 
loading you can use the USR stateaent, i.t. D£FUSR*fcHAIIBiA"USR(D). 
Note that soaa fora of duaay arguaent is required by BASIC even 
though it it aeanlngless. You can shuttle between ZEN and. BASIC 
whenever you like without effecting any files or data in eeaory. 

Copy This coeaand aoves a block of ataory. You will be proopted for 
START), STOP) and DESTINATION) parameters. Within ZEN's coeaand 
structure a nuatric paraaetar aay be a deciaal, hexadeclaal or octal 
nuaber. Hex nuebtrs are *H* postfixed and octal are *0* postfixed. 
So if you wanted to eove the block of ataory froa 2IIH to 2FFH up to 
CHIN you would type 2IBH(RETURN), 2FFH(RETURN) and CHIN (RETURN). 

Down This coeaand aoves the editor current line down by the nuaber 
of lines specified in th* coaaand paraaetar. For exaaplc D37(RETURN) 
aoves down thirty-seven lines. The default coaaand paraaeter is one 
so D(RETURN) aoves down one line. The editor in ZEN is line 
orientated as in BASIC but docs not use explicit line nuabers, 
instead you use various coeaands to aove around the text file until 
you reach the required position. You then use the ENTER or ZAP 
coeaands to insert or delete lines of text. If the DOWN coaaand 
buapt into tha tnd-of-fi1• then the aeisage EOF will be displayed. 

Enter This coaaand enters lines of text into the text file. ZEN will 
display the current line nuaber, type in your line of text than 
press (RETURN). This process will repast until you type a full stop 
as the first character on the line, this returns you to coaaand 
level. Your text Is placed in the file at the current line, the old 
current and following lines are aoved downwards towards EOF. Note 
that although line nuabers are often displayed by ZEN these are 
dynaaically coeputcd and not stored in the text file. 

. Fill This coaaand fills a block of ataory, froa START) to STOP) 
inclusive with a DATA) value. You will be proapted for all thraa 
par setters. 
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Sor t This coaaand will tort and display the syabol tabl e produced 
during the 1 ait ataeably. You Mill be proapted lor an output option. 
Your ‘poiaibls rtsponstt are tha saaa at for tha Aaseebler list 
output. The output of this coaeand is generated a page at a tiae at 
m 1th list output. You can restrict the sort precise to eyebolt 
beginning Nlth a particular latter by entering that latter at a 
coaeand paraaater. For eiaaple SB(RETURN) Mould only produce tha 
tyebolt beginning with the letter '■*. Note that tyebolt are only 
sorted on tha first latter and not tha uhole naae. 

Target Thit coaaand Mill aova you to any line in the text file and 
take 1t the currant line. Tha coaaand paraaater specifies the line 
nuaber, for exaeple T1433(RETURN) would aove you to line one 
thousand four hundred and thirty-five. The default coaaand 
paraaeter, T (RETURN), aovas you to the start-of-fi1e. 

Up This coaaand aovas you up the text file by tha nuaber of lines 
specified in tht coaaand paraeeter. The default paraaater is one. 

Verify This coaaand verifies • file which has just been written to 
castattOf the coteand paraaater specifies the type of file. This 
coaaand aust be used - INHEDIATELY after a write to work correctly. 
This Is because NSX filet have no chtcktua associated with thea. ZEN 
will retain an Internal checktua after a write and coapare this with 
the one coeputed during the verify coaeand. 

V(RETURN) will verify a test file, no data it actually read into 
aeeory. 

VB(RETURN) will verify a blirary file, no data it actually read 
into aeeory. 

i 

brite This coaaand writes aa area of aeeory to a cassette, the 
coaaand paraaater specifies the type of file. 

N(RETURN) will write ill the text in aeeory as an ASCII text 
file. You will be proapted for a filenaae as described in the READ 
coaaand* ZEN teat files are standard HSX teat files (at generated by 
the BASIC SAVE coaaand) with a CR,LF between lines and a CTRL-Z end- 
of-flte nark, 

MB(RETURN) will write an area of aeeory as a binary file. You 
will be proapted for START), STOP), LOAD), and EXEC) addresses. The 
start and stop addresses define the area of aeeory (inclusive) to be 
written. The load address defines the address at which the file will 
toad back in when READ or BUOAOed, if you default then the file will 
be loaded back In at its start addrsss. The exec address defines the 
file's execution (entry) address. 

laalne This coaaand displays the ZBI registers saved in the User 
laage. The top line shows the ealn registers and the lower line the 
ZBI alternate register set. 

Zap This coagand reaoves a nuaber of lines free the text file as 
specified by the coaeand paraaater. For exaeple ZlfS(RETURN) Mould 
reaove one hundred and eight lines, coaaencing wt th the current 
line. The default coaaand paraaater Is one. 
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disassemble This command parf or ms a lyibtllc ^liimtbly on on area 
ef memory and generates a t»»t flie or listing at output. You Hill 
bo prooptod for the START> and STOP) tddratttt inclusive of the area 
you with to disassemble. You will than b« atkad tho addratt which 
tha program RUNS AT). Soaatioat you aay hava a proyrai In ataory at 
a different location to it's utual run-tlaa location, tha 
diaatiaabltr can ralocata any addratiat and 1abalt in it's output to 
reflect tbi*. . If yew dafault to tha request for tho r«ft*tiia start 
addratt thon ZEN atftaii that tho program It at lt*i normal run-time 
location. If yoo supply an actual addratt paraaatar than tha output 
Ilia «lll reflect this run-tint addratt. You will than bt atkad, 
repeatedly, for tha START) and STOP) addrattat inclusive of any data 
araaa within tho ditattoably region. . These aro araat which-will not 
bo decoded at instructions but at data bytea. To torn!nato this 
process typo In a stop address of zero. Thara is a maximum of sixty- 
four separata data areas, if you exceed this nuaber ZEN Mill 
generate tho error nassaga FULL. You Mill not) be asked for an output 
OPTION). You say tpsclfy V{RETURN!, P{RETURN) or E(RETURN) for 
listings to tha video, printer or external devices. If you default 
than ZEN Mill generate a text file and add it to tha and of any text 
already in aaaory. If tha text file grows up to tha top of eeaory 
llnit during disassembly than tha error sassage MEMORY is issued and 
disassembly tarelnatas. Tha only othir error condition posiibla 
during disassembly is for tha symbol table to fill up in which case 
tha error sassage FULL is Issued. Note that the disassembler uses 
the sent syabol table at the assembler and to destroys any tyebols 
there. This it only of relevance if you which to perfors a later 
SORT operation. Any illegal opcodes encountered during disassembly 
art treated as data statements. Labels of the fors Lnnnn {where nnnn 
is an address) will be generated at the appropriate positions if 
possible. 

unscramb1e This command is a simplified version of the disassembler. 
It will disatteeble eight Z89 instructions beginning at the address 
specified by the command parameter. For example ul(RETURN) mill 
disassemble the start of the BASIC ROM. If you default on the 
address parameter then the command continues from where it last 
finished. Any illegal opcodes encountered are displayed as data 
bytes. ZEN will try to make an intelligent guess about how to 
display eight bit numeric operands. Numbers less than ten are 
displayed as single digit decimals. Numbers from from 41X to 3AH and 
ilH to 7AH are displayed as ASCII 1itsral characters. Other numbers 
are displayed as hex values with a leading zero if necessary. 
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Further Inf oraation 


List Output t 

The coaaands Asseabl e , Sort and dlsis teabla can all generat t 
1arge quantities of output to tha video, printar or external 
davic**• Ut th these coaaaands tha output h( 11 ba generated a page at 
a tine Kith a abort pauia between aach page. Preislng any key will 
atop output at tha and of tha page, to raatart prait any kay except 
'O’. This kay Mill forca the coaaand to OUIT and return to tha 
coanand loop. 

Tha printer and external device! are asauaad to be eighty 
character! Hide by sixty-slx 1Inei long i.a a typical printer. If 
you have something different than you will need to aodify ZEN. You 
can change the page length by aodifylng tha PAGE procedure (sea ZEN 
listing). You can change tha various field widths by aodifying the 
group o# constants CQhNlOTH/SYHNIOTH. Tha first byte of aach of 
these constant pairs defines an external/printer device field uidth, 
tha second defines a video device field uidth. You aay also change 
the nuaber of syabols per line produced during a SORT, as there is a 
switch in the coda specifically for this purpose. 

The eiternal/printar devices are prasuaed to respond to tha ASCI I 
control characters Formfeed (ICH), Carriage Return (9 DH> and 
Linefeed (BAH). ZEN issues a Forafeed followed by slxty-tuo lines of 
text for each page, each line being terainated by Carriage Return, 
Linefeed* The external device driver it set up to output to the MSI 
RS232 device, ' while the printer driver outputs to the Centronics 
port. The drivers handle EPSON FI-81 type printers as they stand. If 
you have soaething unusual there is space in the driver to insert 
patches, to filter Lineftads for axaapla. ■ 

The video device is itiuaad to be thirty-seven characters wide 
but this can be changed, as for the printer and external devices, if 
an eighty character device bacoaas available. Note that line nuabers 
art not generated on the video device for Asseabler/disasseabler 
listings because of this reduced oidth.!. The syabol, operand and 
coaaent fields of a Z8I stataaant aay be of indefinite length. - If 
necessary ZEN Mill truncate these fields to fit into the required 
foraat. 

Tha Syabol Table 

The syebol table Is tha area of ataory used by ZEN to store 
syabols during Astcably/disassaably. It is situated between ZEN and 
tha text file. If you wish to Increase it's site it is only 
necessary to change tha start-of-flie pointer to the required new 
value, here's how* (1) KILL the text file (2) Use MODIFY to change 
SQFP (31 KILL the text file again to copy SOFP into EOF P and CURRENT 
(4) Per for a an ASSEMBLE to shut down the syabol table (3) Use N8 to 
write the new version to cassette. Note that ZEN is a coapletely 
'soft' prograta, any changes you aake will be reflected in the new 
version. „ 
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Aitetbler Byntat 

ZCM expects assembly language stateaents to b« constructed 
according to thi syntax dcf lnad in tho ZIL08 ZBB Asseably Linguifi 
Frogr aaal ng Manual, ZEN deviates froi the standard in ont instanco 
in thot it expects EX AF,AF rather than EX AF,AF’. Tho soction 
following this ono contains an alphabttlcaUy sorted listing of tha 
•ntirc 188 instruction sat. Each aasanhly language statanant nay ba 
divided! Into a aaxlaua of four logical fields, they aret " 

u) Label 
(2) Operator 
13) Operands 
U) 1 Consent 

Labal_ A label is a way of narking a statanant so that other 
statenants can refer to it. Line nunbars serve the sane purpose in 
BASIC, you would use 88T0 248 for eianple. Assenbly Language allows 
you to use a syabollc nane for a label. When you declare the label 
it suit be postflied with a colon ‘i’ no that the asseabler knows 
that it s a label. A label oust.begin with a letter but nay contain 
letters or digits after that. 2EH allows labels of any length with 
all characters being significant. The register end condition-code 
naees nay not be used as syabols as these arc reserved Identifiers. 
Any atteept to do so will result in an error aissaga. 

Operator There art sixty-seven operators in the Z9B Assenbly 
Languagt. In addition ZEN supports seven PSEUDO-OPS, they arei 

END This pseudo-op terninates asseably, it MUST be used. 

DS or DEFS Define Storage skips over the nuaber of object locations 
specified by the operand. 

BN or DEFN Define Nord places the operand in the object file in 
reverse order as required by the ZB8 word instructions, 

DB or DEFB Define lytets) places the operand(s) in the object file 
at successive locations. Operands are delinited by coaaas, each 
operand say bn an expression with value less than 234 or nay be a 
literal string. Literal strings nay be of any length but cannot fora 
part of an expression. 

£9U Equate assigns the value of the operand to a syabolic 
identifier. Any syabolic identifiers used in the operand expression 
oust already be known to the asseabler. This ’no forward reference * 
rule Is designed to prevent circular referencing. 

0R6 Origin defines the start address of the object file. This 
pseudo-op can be used as often as needed to produce sections of code 
at different addresses.■ The ‘no forward reference* rule applies to 
the operand. 

LOAD Coaaenets loading code into aeaory at the operand address. Use 
of a subsequent ORfi pseudo-op will turn this process off, you arc 
explicitly required to re-establish the 1 oaamg process. 



H JX ZEN Raftrance Nanual 


Operands Tha nuabar of operands in a atataaant dapanda upon the 
optrator, Thera ara niladic, aonadic and dyadic oparatora in tha Z81 
instruction aat• Thaaa taka iaro f ana and tao operands raspectivtl y. 
Thara aro thraa clatsat of oparandi 

<11 Rag 1 atari {A.B.C.D.E.H.L,I,R,HL,DE,BC,AF,IX,IY,SP> 

(2) Condition-codes INZ,Z,NC,C,P0,PE,P,M> 

(1) Nuaorlc expressions 

A nuaaric expression i• coapoiad of ona or aora of tha f ol1OMi»g 
-aiaaanta datiaitad by tha infix aath apcratorai 

(1) A daclaal, hex or octal nuabar. Deciaal ia tha default bata with 
hex nuabari being 'H‘ postflxed and octal 'O' po*tfixed. Nuabart 
auit begin ai th a digit, a leading zero Mill be needed with soae hex 
nuaberi. 

(2) A literal character enctoied in single or double quotes. 

<3) The I character. This variable aiale* tha prograe countar of tha 
run-tiae prograa. 

(4) A syabolic naaa. Tha aisaablar Mill usa tha associated value in 
evaluating the txprassion. 

The infix aath oparatora arai 

*■ addition 
- subtraction 

♦ Multiplication , 

/ division 
I logical AND 
. logical OR 

Exprassions art evaluated STRICTLY LEFT TO RI6HT Mith no 
precedence ordering. Arithmetic is sixteen bit unsigned integer and 
overf1 on Mill be ignored. 

Coaaent s Coaaents are ignored by tha ass tablar. They begin aith a 
seat-colon *|‘ and ara tarainated by the end-of-1ine. 
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Atteebler Error Handling 

If tht iiiiitlir find* a syntax arror the following Mill happens 
(11 Atteably terminate*. 

(2) An arror aettage ia displayed. 

(3) Tha of landing lino it dlaplayad and ii aada tha adltor currant 

lina. 

(4) Tha eoaaand loop it re-antarad. - 

JTou can now corract tha arror and ra-atiaabla. It It impossible 
to aaka a tyntai arror which will danage ZEN or anything in neaory. 
Tha arror aattagat artt 

UNDEFINED You hava atad an undaclarad symbol. 

SYMBOL You hava dtclarad a zero langth tyabol or have forgotten tha 
tyabol needed with an EDU pteudo-op. 

RESERVED You hava triad to ute a reserved word for a tyabol• 

FULL Tha tyabol table it full. 

DOUBLE SYMBOL You hava declared the taac tyabol tore than once. 

EOF You have forgotten END and have hit end-of-file. 

0R61 You have forgotten ORG• 

HUH? The lestebler it completely baffled. 

OPERAND You have done toeething wrong with an operand, thit covert a 
•ultitude of tint! Mott type* of tyntai error will coae under thit 
heading at well at errort of tagnitude. Thete occur when you try to 
offset too far with a relative jump or indeiing instruction. 



